home *** CD-ROM | disk | FTP | other *** search
/ AOL File Library: 9,300 to 9,399 / 9300.zip / AOLDLs / HTML & Web Tools (MAC) / RTF_ RTFtoHTML v 3.9.3 / R2HPPC.sit / r2h / rtftohtmlppc.rsrc / TEXT_1000_Help.txt < prev    next >
Text File  |  1998-02-12  |  4KB  |  88 lines
  1. RTFtoHTML documentation is included (in HTML format) in
  2. the general distribution. You may find the latest information
  3. at http://www/sunpack.com/RTF - as well as the latest
  4. version.
  5.  
  6. RTFtoHTML is shareware. If you use it, please send
  7. $29.00 (US) to 
  8. Chris Hector
  9. 6195 Sinclair Rd.
  10. Mound, MN. 55364
  11.  
  12. Read the file License.htm for details.
  13.  
  14. To contact me, send email to 
  15. chris@sunpack.com
  16.  
  17. Here is a brief description of the options (in man-page style)
  18.  
  19.  
  20.  
  21. -hlevel 
  22.        to split the document at headings of level level, 
  23. -c 
  24.        to create a table of contents, and 
  25. -x 
  26.        to create an index (of course, this requires index entries to be in the RTF document)
  27.  
  28. These should suffice in most cases. When invoking rtftohtml without any arguments, a list of all
  29. available options is printed. Following is a complete and detailed list of all available command
  30. line options, sorted alphabetically:
  31.  
  32. -c 
  33.        Generate a table of contents on a separate page (the title page itself normally only
  34.        contains the level-1-headings). 
  35. -G 
  36.        Indicates that no graphics files should be written. The hypertext links to the graphics
  37.        files will still be generated. This is a performance feature for when you are
  38.        re-translating a document and the graphics have not changed. 
  39. -hlevel 
  40.        This tells rtftohtml to split the generated HTML document at all headings of level,
  41.        thus creating a separate HTML file for the contents of every section at that level. If
  42.        level is 0, only one HTML file will be created with a table of contents at the top of the
  43.        HTML file. If level is omitted, rtftohtml will create a separate HTML file for every
  44.        section.
  45.        For example, -h1 only splits the HTML-File when a level-1-heading is encountered. All
  46.        lower level headings will be internally referenced from the top of the respective
  47.        HTML-File.
  48.        This option is also required for the -c and -x options. 
  49. -i 
  50.        Indicates that imbedded graphics should be linked into the main document using an
  51.        IMG tag. The default is to use an HREF style link. 
  52. -N file 
  53.        If the -h option has been given, this option allows you to tell rtftohtml that it should
  54.        read the description for the navigation panels it produces from file file. Navigation
  55.        panels are described in more detail in section Navigation panels. 
  56. -o filename 
  57.        Indicates that the basic output file name should be filename. If any other files are
  58.        created (such as for graphics), the basename of the other files will be filename 
  59.        without ".rtf" if it is present in the name. 
  60. -P extension 
  61.        Use extension as the extension for any links to graphics files. The default for this is
  62.        "gif". 
  63. -s 
  64.        Use short filenames when splitting the HTML output. In this case the HTML-files are
  65.        simply numbered. If this option is not present the file-names contain the first eight
  66.        characters of the first heading contained in the respective files. 
  67. -t 
  68.        Place external references to headlines near the top of the page. (Default is that they
  69.        occur at the and of the page.) 
  70. -T title 
  71.        Use title as the document title. This overrides any title supplied within the RTF-file
  72.        (see also section Supplying a title).
  73.        (Note: Stock rtftohtml uses this switch to prevent the generation of a table of 
  74.        contents.
  75.        Since this conflicts with rtftoweb's ToC-handling anyway, I have redefined this
  76.        command line switch.) 
  77. -x 
  78.        Generate an index. This works by gathering all the index entries of the RTF-File and
  79.        inserting an invisible anchor at that place. 
  80. -X text 
  81.        By default, rtftohtml inserts index anchors without any text, thus producing "empty
  82.        anchors" which most Web browsers have no problems with. Unfortunately there is one
  83.        prominent exception to this statement: NCSA Mosaic. Mosaic requires anchors to
  84.        contain at least one non-blank character, otherwise they are not recognized. This option
  85.        lets you use text as the text of such anchors when using Mosaic as your Web browser,
  86.        e.g. "-X ·".
  87.  
  88.